<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>IBM Visualization Data Explorer Programmer&#39;s Reference</TITLE>

<META HTTP-EQUIV="abstract" CONTENT="IBM Visualization Data Explorer
Programmer&#39;s Reference">
<META HTTP-EQUIV="contact" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="owner" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="updated" CONTENT="Tue, 16 Sep 1997 ">
<META HTTP-EQUIV="review" CONTENT="Fri, 14 Aug 1998 ">

<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF">

<A NAME="Top_Of_Page"></A>
<H1>IBM Visualization Data Explorer Programmer&#39;s Reference</H1>
<B>&#91; <A HREF="#Bot_Of_Page">Bottom of Page</A> &#124; <A
HREF="progu321.htm">Previous Page</A> &#124; <A HREF="progu323.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B><HR><P>
<H3><A NAME="HDRDXSPC" HREF="progu097.htm#PToC_416">DXSetPendingCmd</A></H3>
<A NAME="IDX2097"></A>
<P><STRONG>Function</STRONG>
<P>
Enters a task into a list of tasks to be run at the end of each
graph (visual program) execution.
<P><STRONG>Syntax</STRONG>
<BR>
<TT><STRONG><BR>
&#35;include &lt;dx/dx.h&gt;<BR>
<P><BR>
Error DXSetPendingCmd(char *major, char *minor, int(*task)(Private),<BR>
                      Private data);<BR>
</STRONG></TT><BR>
<P><STRONG>Functional Details</STRONG>
<P>
The task to be run (<TT><STRONG>*task</STRONG></TT>) is identified by two
character strings:
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><B><TT><STRONG>*major</STRONG></TT>
</B></TD><TD><P>typically contains the calling module&#39;s ID.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>*minor</STRONG></TT>
</B></TD><TD><P>typically indicates which of several discrete tasks the module
has entered.
</TD></TR></TABLE>
<P>
When execution of the graph is completed, the tasks in the list are
executed in the order in which they are received.
(If tasks are entered by two different modules, the order in which
the modules run determines the order in which the tasks are
called.)
<P>
When <TT><STRONG>*task</STRONG></TT> is called, it is passed
<TT><STRONG>*data</STRONG></TT> as a parameter.
The specified task is called at the end of each execution until it is
removed from the pending-task list.
Removal can be achieved by calling the routine again, with the same
strings for <TT><STRONG>*major</STRONG></TT> and
<TT><STRONG>*minor</STRONG></TT>, but setting
<TT><STRONG>*task</STRONG></TT> to NULL.
<P><STRONG>Return Value</STRONG>
<P>
Returns OK or returns ERROR and sets and error code.
<P><STRONG>See Also</STRONG>
<TT><STRONG>
<A HREF="progu185.htm#HDRDXGMID">DXGetModuleId</A>
</STRONG></TT>
<P>
<A HREF="progu060.htm#HDRPNDCMD">13.6 , "Pending Commands"</A>.
<P><HR><B>&#91; <A HREF="#Top_Of_Page">Top of Page</A> &#124; <A
HREF="progu321.htm">Previous Page</A> &#124; <A HREF="progu323.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B> <br><b>&#91;<a
href="../allguide.htm">Data Explorer Documentation</a>&nbsp;&#124;&nbsp;<a
href="../qikguide.htm">QuickStart Guide</a>&nbsp;&#124;&nbsp;<a
href="../usrguide.htm">User&#39;s Guide</a>&nbsp;&#124;&nbsp;<a
href="../refguide.htm">User&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../proguide.htm">Programmer&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../insguide.htm">Installation and Configuration
Guide</a>&nbsp;&#93;</b><br><p><b>&#91;<a
href="http://www.research.ibm.com/dx">Data Explorer Home
Page</a>&#93;</b><p><HR ALIGN=LEFT WIDTH=600><b>&#91;<A
HREF="http://www.ibm.com/">IBM Home Page</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Orders/">Order</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Search/">Search</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Assist/">Contact IBM</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Legal/">Legal</A>&nbsp;&#93;</b><hr><p>
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
